home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DISK / TOY202.ARJ / GUIDE.TXT < prev    next >
Text File  |  1992-05-27  |  43KB  |  936 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                          ToyBox (tm) II User's Guide
  7.  
  8.                  Copyright 1991, 1992 Virtual Magic Software
  9.                              All Rights Reserved
  10.  
  11.  
  12.                          Virtual Magic Software (tm)
  13.                                  P.O. Box 615
  14.                            Fort Monmouth, NJ 07703
  15.  
  16.                            CompuServe:  70304,2045
  17.                               Prodigy:  CJKH33A
  18.  
  19.  
  20.              Member of the Association of Shareware Professionals
  21.  
  22.  
  23.  
  24.       INTRODUCTION...................................................2
  25.  
  26.       SYSTEM REQUIREMENTS............................................2
  27.  
  28.       REGISTRATION INFORMATION.......................................3
  29.  
  30.       INSTALLING TOYBOX II...........................................4
  31.  
  32.       STARTING TOYBOX II.............................................4
  33.  
  34.       MOVING AROUND IN TOYBOX II.....................................5
  35.  
  36.       ADDING A PROGRAM OR PAGE.......................................7
  37.  
  38.       REMOVING A PROGRAM OR PAGE....................................10
  39.  
  40.       VIEWING/MODIFYING A PROGRAM OR PAGE...........................10
  41.  
  42.       SETTING HELPER WINDOW OPTIONS.................................10
  43.  
  44.       RUNNING AN INSTALLED PROGRAM..................................11
  45.  
  46.       PAINTER.......................................................12
  47.  
  48.       TIPS AND TECHNIQUES...........................................14
  49.  
  50.       COMPATIBILITY WITH EARLIER VERSIONS...........................16
  51.  
  52.       LICENSE AND WARRANTY..........................................16
  53.  
  54.       (Any last-minute additions/corrections to this User's Guide are 
  55.       listed in the README.TXT file on disk.)
  56.       
  57.       ============
  58.       INTRODUCTION
  59.       ============
  60.  
  61.       ToyBox II is a beautiful, powerful EGA/VGA graphical program 
  62.       manager designed for users of all ages.  Program managers, often 
  63.       called menu programs, allow you to run a program by choosing it 
  64.       from a list of programs on the screen.  You don't have to remember 
  65.       cryptic DOS commands for each program.  When you're finished 
  66.       running a program, the program manager automatically reappears, 
  67.       allowing you to select another program to run.  Graphical program 
  68.       managers go a step further and use colorful pictures or icons to 
  69.       represent programs.
  70.  
  71.       ToyBox II is unique because it has all the features found in 
  72.       program managers designed for adults, yet it can be safely and 
  73.       easily used by young children.  It is incredibly easy to set up 
  74.       programs to run from ToyBox II.  Simply enter the program title, 
  75.       where the program is on disk, and the name of the icon you want to 
  76.       use to represent the program.  File pick-lists make your job even 
  77.       easier.  When you're finished, ToyBox II will create a large 3-D 
  78.       button with the icon you've chosen.  From then on, you or your 
  79.       child can start the program simply by moving the cursor or mouse 
  80.       pointer to the button and pressing a key or clicking a mouse 
  81.       button.  Children really enjoy being able to start their own 
  82.       programs without help. 
  83.  
  84.       You can design your own icons with the easy-to-use icon editor 
  85.       built in to ToyBox II, or you can use readily-available Microsoft 
  86.       Windows icons.  ToyBox II allows you to set up multiple levels of 
  87.       menu pages which can hold several thousand programs (if you have 
  88.       that many).  You can password protect individual programs or 
  89.       entire menu pages.  You can assign hotkeys to run particular 
  90.       programs or open menu pages.  You also have the option of 
  91.       providing variable program parameters at the time you run a 
  92.       program.  ToyBox II requires no memory for its own use while it is 
  93.       running your programs.
  94.  
  95.  
  96.       ===================
  97.       SYSTEM REQUIREMENTS
  98.       ===================
  99.  
  100.       - MS-DOS 3.0 or later
  101.       - EGA/VGA
  102.       - 512K RAM
  103.       - Hard Disk
  104.       - Microsoft-compatible Mouse (optional)
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.                                       2
  112.       ========================
  113.       REGISTRATION INFORMATION
  114.       ========================
  115.  
  116.       We distribute ToyBox II as a shareware program, which means we 
  117.       allow you to try the program out before you pay for it.  If you 
  118.       find ToyBox II helpful and continue to use it, please send a $29 
  119.       (U.S.) registration fee to:
  120.  
  121.                             Virtual Magic Software
  122.                                  P.O. Box 615
  123.                            Fort Monmouth, NJ 07703
  124.  
  125.       We have included an order form (ORDER.TXT) on disk which you can 
  126.       print out if you desire.  If you choose not to use the order form 
  127.       to register, we need to know your name, address and desired disk 
  128.       size (3.5" or 5.25") to fulfill the order.  New Jersey residents 
  129.       must add 7% sales tax ($2.03 per copy).  We accept checks and 
  130.       money orders in U.S. funds drawn on U.S. banks.  We recommend you 
  131.       do not send cash.
  132.  
  133.       You can also order by credit card (VISA, MC, AmEx, Discover) from 
  134.       Public (software) Library by calling 800-242-4PsL (from overseas: 
  135.       713-524-6394) or by FAX (713-524-6398) or via CompuServe   
  136.       (71355,470).  Ask for item #10535.  These numbers are for ordering 
  137.       only.  Virtual Magic Software can NOT be reached at these numbers.  
  138.       For information about dealer pricing, volume discounts, site 
  139.       licensing, the status of shipment of the product, the latest 
  140.       version number or for technical information, or to discuss 
  141.       returns, contact Virtual Magic Software directly at the above 
  142.       mailing address.  You can also contact us on CompuServe 
  143.       (70304,2045) or Prodigy (CJKH33A).  If you have any questions or 
  144.       comments about ToyBox II, even if you have not yet registered, 
  145.       please let us know.  It is through your comments and suggestions 
  146.       that we can make ToyBox II and future products even better.  When 
  147.       you register, we'll send you a disk containing the latest version 
  148.       of ToyBox II, plus a collection of hundreds of Microsoft Windows 
  149.       icons which you can use in ToyBox II.  Registered users are 
  150.       entitled to free technical support for as long as we distribute 
  151.       the program.  Technical support will be provided via mail, 
  152.       CompuServe and Prodigy.  We'll also send you notice of upgrades 
  153.       and additional Virtual Magic Software products in the future. 
  154.  
  155.       This program is produced by a member of the Association of 
  156.       Shareware Professionals (ASP). ASP wants to make sure that the 
  157.       shareware principle works for you. If you are unable to resolve a 
  158.       shareware-related problem with an ASP member by contacting the 
  159.       member directly, ASP may be able to help. The ASP Ombudsman can 
  160.       help you resolve a dispute or problem with an ASP member, but does 
  161.       not provide technical support for members' products. Please write 
  162.       to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or 
  163.       send a CompuServe message via CompuServe Mail to ASP Ombudsman 
  164.       70007,3536.
  165.  
  166.                                       3
  167.       We encourage you to pass along a copy of ToyBox II to friends, 
  168.       associates, computer bulletin board systems, etc.  To ensure only 
  169.       unmodified versions are distributed, we ask that you distribute 
  170.       only the original, unaltered compressed versions of the program.  
  171.       Please encourage others to register their copy if they find the 
  172.       program useful.
  173.  
  174.       For license and warranty information, please see the "License and 
  175.       Warranty" section at the end of this User's Guide.
  176.  
  177.  
  178.       ====================
  179.       INSTALLING TOYBOX II
  180.       ====================
  181.  
  182.       Normally ToyBox II is distributed as a single compressed file 
  183.       named either TOY202.EXE or TOY202.ZIP.  After you have 
  184.       decompressed this file, the following files which make up the 
  185.       complete ToyBox II program should be in a single directory on your 
  186.       hard disk:  TB2.BAT, TB2MAIN.EXE, SEE.EXE, TB2.INF, TB2-NU.INF, 
  187.       TB2-SI1.INF, TB2-SI2.INF, GUIDE.TXT, README.TXT, REGISTER.TXT, 
  188.       ORDER.TXT, VENDOR.TXT, FILE_ID.DIZ, TOYBOX.ICO, eight internal 
  189.       files that end with a ".TBI" extension, and 30 sample icon files 
  190.       that end with a ".ICN" extension.  If you desire you can move the 
  191.       text (".TXT") files, the icon (".ICN") files, and TOYBOX.ICO to 
  192.       another directory, but the remainder of the files must not be 
  193.       deleted and must remain together in one directory.
  194.  
  195.       After you have installed some of your programs to run under ToyBox 
  196.       II, you may see some additional files with a ".$$$" extension.  Do 
  197.       not move or remove these files.  You should periodically back-up 
  198.       these files, as well as the ".INF" files, because they contain 
  199.       information on the programs you have installed in ToyBox II.
  200.  
  201.  
  202.       ==================
  203.       STARTING TOYBOX II
  204.       ==================
  205.  
  206.  
  207.       FROM THE DOS PROMPT
  208.  
  209.       First change to the directory containing the ToyBox II files (or 
  210.       ensure this directory is in the PATH statement in your 
  211.       AUTOEXEC.BAT file), then type "TB2".  ToyBox II automatically 
  212.       detects whether your system has an EGA or VGA compatible graphics 
  213.       card and switches to the highest graphics mode available.  It will 
  214.       also detect the presence of a mouse if you have a mouse driver 
  215.       installed.  If you have display problems, such as part of the main 
  216.       ToyBox II page not being visible, or the mouse pointer not 
  217.       displaying, you can force ToyBox II into the correct graphics mode 
  218.  
  219.  
  220.  
  221.                                       4
  222.       by typing "TB2 E" for EGA or "TB2 V" for VGA.  If the mouse 
  223.       pointer still doesn't display, check to ensure you have a mouse 
  224.       driver properly installed.
  225.  
  226.       You can include the "TB2" command in your AUTOEXEC.BAT file to 
  227.       cause ToyBox II to automatically run when you turn on your 
  228.       computer.  If you aren't familiar with the purpose and contents of 
  229.       your AUTOEXEC.BAT file, we recommend you have someone help you 
  230.       with this.
  231.  
  232.  
  233.       FROM MICROSOFT WINDOWS
  234.  
  235.       We've included a special icon for Microsoft Windows named 
  236.       TOYBOX.ICO.  Follow instructions in the Microsoft Windows User's 
  237.       Guide to install and run ToyBox II as a DOS application under 
  238.       Windows.
  239.  
  240.  
  241.       ==========================
  242.       MOVING AROUND IN TOYBOX II
  243.       ==========================
  244.  
  245.       When you open a window, such as the Helper window described later, 
  246.       it pops up on top of the current page and any windows that may 
  247.       already be displayed.  The top window is always the active window.  
  248.       You can only access objects (normally buttons and text boxes) that 
  249.       are in the active window.
  250.  
  251.  
  252.       SELECTING OBJECTS - MOUSE
  253.  
  254.       Move the mouse pointer to the desired object and click any of the 
  255.       mouse buttons.  To make it easier for small children, all mouse 
  256.       buttons have the same effect.
  257.  
  258.  
  259.       SELECTING OBJECTS - KEYBOARD
  260.  
  261.            1)  ALT Key:  Objects normally have an ALT key combination 
  262.       associated with them.  Most objects have one or more words under 
  263.       them or to the right of them describing the function of the button 
  264.       or box.  One of the letters in the words will have an underscore 
  265.       beneath it.  To select the object, hold down the ALT key and press 
  266.       the letter that is underscored.  For example, at the Helper 
  267.       window, to select the Add Program or Page button, hold down the 
  268.       ALT key and press "A".  Some buttons don't have text descriptions.  
  269.       The keys to select these buttons are:
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                       5
  277.                 - STOP Button:  ALT+S (only at title page)
  278.                 - Painter Button:  ALT+P (only at title page)
  279.                 - Information Button:  ALT+I (only at title page )
  280.                 - Close Window Button:  ESC
  281.                 - Helper Button:  ALT+H
  282.                 - OK Button:  ALT+O
  283.                 - Up-Arrow Button:  Page Up
  284.                 - Down-Arrow Button:  Page Down
  285.  
  286.            2)  Outline Cursor:  In some windows you must use the arrow 
  287.       keys on your keyboard to move from one object to the next.  A red 
  288.       outline cursor will indicate the current object.  To select the 
  289.       current object, press the ENTER key.  (If you have a mouse, this 
  290.       red outline cursor can be turned off if you intend to use only the 
  291.       mouse to select objects.  See "Setting Helper Window Options" 
  292.       below for instructions.)
  293.  
  294.  
  295.       EDITING TEXT
  296.  
  297.       To add programs to ToyBox II, you must enter certain program 
  298.       information such as program title, filename, etc., into text 
  299.       boxes.  This section describes the general procedures for entering 
  300.       and editing text in text boxes.
  301.  
  302.            1)  Positioning the Text Cursor (Mouse):  Move the mouse 
  303.       pointer directly to the desired location within any of the text 
  304.       boxes in the active window and click one of the mouse buttons. The 
  305.       text cursor (a thin black vertical line) will move to the mouse 
  306.       pointer position.
  307.  
  308.            2)  Positioning the Text Cursor (KeyBoard):  Select the 
  309.       desired text box using the ALT key combinations or up and down 
  310.       arrow keys as described above.  Move around within the text box by 
  311.       using the left and right arrow keys.  Pressing the TAB key or 
  312.       ENTER key will move the text cursor to the next text box.  
  313.       Pressing the TAB key while holding down SHIFT key will move the 
  314.       text cursor to the previous text box.
  315.  
  316.            3)  Entering Text:  After positioning the text cursor, begin 
  317.       typing.  The text will be inserted at the text cursor location.  
  318.       ToyBox II will not allow you to enter more text than will fit 
  319.       inside the text box.
  320.  
  321.            4)  Deleting Text:  To delete a character to the right of the 
  322.       text cursor, press the DELETE key.  To delete a character to the 
  323.       left of the text cursor, press the BACKSPACE key.
  324.  
  325.  
  326.       CLOSING THE ACTIVE WINDOW OR PAGE
  327.  
  328.       Select the button in the upper left corner of the window/page with 
  329.       the mouse or press the ESCAPE key.
  330.  
  331.                                       6
  332.       SAVING CHANGES
  333.  
  334.       After you have made configuration changes, such as adding a new 
  335.       program or disabling the STOP button, you must save these changes 
  336.       to disk.  Do this by selecting the OK button with the mouse or 
  337.       typing ALT+O.  If you decide you don't want the changes to be 
  338.       made, simply close the window without saving them.
  339.  
  340.  
  341.       MOVING BETWEEN PAGES
  342.  
  343.       Page buttons are treated identically to program buttons.  When you 
  344.       select a page button, the page is displayed.  To close the current 
  345.       page and return to the previous page, select the button in the 
  346.       upper left corner of the page or press the ESCAPE key.
  347.  
  348.  
  349.       ========================
  350.       ADDING A PROGRAM OR PAGE
  351.       ========================
  352.  
  353.       Open the Helper window by selecting the Helper button (the red 
  354.       cross) or by typing ALT+H.  Select the Add Program or Page button 
  355.       to open the Add Program or Page window.  This window contains the 
  356.       following objects:  
  357.  
  358.            1)  Files Button:  Select this button to open a window 
  359.       containing a list of files and directories on the current drive.  
  360.       Selecting a file from the list will automatically fill in the Path 
  361.       and Program text boxes.  Directories are indicated by a backslash 
  362.       ("\") at the end of the name.  Selecting a directory will cause 
  363.       the files for that directory to be displayed.  Selecting the "..\" 
  364.       entry will display the files of the parent directory of whatever 
  365.       directory you are currently in.  If the file list contains more 
  366.       than 16 files and directories, select the blue arrow buttons (or 
  367.       press the Page Up and Page Down keys) to display the next or 
  368.       previous 16 files.  ToyBox II can store 1024 directory/file names 
  369.       at a time.  If the current directory contains more than 1024 
  370.       directory/file names, ToyBox II will only display the first 1024.  
  371.       If you wish to add a program from a drive other than the current 
  372.       drive, you must enter the Path and Program information manually, 
  373.       as described below.
  374.  
  375.            2)  Icons Button:  This button works the same as the Files 
  376.       button except that it lists only ToyBox II icon (*.ICN) files.  
  377.       Use this to automatically fill in the Icon text box.
  378.  
  379.            3)  Copy Button:  Select this button to copy all program 
  380.       information currently in the Add Program or Page window to a 
  381.       temporary storage area in memory or "clipboard".  This information 
  382.       can later be pasted into another program being added or modified. 
  383.       The information remains in the clipboard until you: (1) overwrite 
  384.  
  385.  
  386.                                       7
  387.       it by using the Copy button again, (2) run an application, or (3) 
  388.       exit ToyBox.  You cannot copy information if the Page button 
  389.       (discussed below) is set to "YES".
  390.  
  391.            4)  Paste Button:  Select this button to paste clipboard 
  392.       information to the program currently being added or modified.  
  393.       This is useful if you want to duplicate the same program button on 
  394.       more than one page.  
  395.  
  396.            5)  Button Title Text Box:  Enter a title for the program or 
  397.       page button.  This title will appear under the button.  If you are 
  398.       entering information for a page button, this will also be the 
  399.       title at the top of the page when it is opened.
  400.  
  401.            6)  Password Text Box:  You may enter an optional password 
  402.       which a user must enter to start the program or open the page.  
  403.       Passwords are always displayed on the screen as a series of   
  404.       asterisks.  This prevents someone looking over your shoulder from 
  405.       viewing the password on the screen.
  406.  
  407.            7)  Key Text Box:  You may enter an optional hotkey to be 
  408.       used to select the program or page.  You can use any printable 
  409.       character as a hotkey.  Upper and lower case letters are treated 
  410.       as the same letter.  Ensure that no two program/page buttons on 
  411.       the same page have the same hotkey, or ToyBox II will always 
  412.       select the first one it finds.  (Note these are not ALT key 
  413.       combinations.  If you enter "M" as the hot key to run a "Mickey 
  414.       Mouse" program, you will just have to press the "M" key to run the 
  415.       program, not ALT+M.)
  416.  
  417.            8)  Path Text Box:  Enter the drive/directory of the program.  
  418.       The easiest way to do this is to use the Files button, which will 
  419.       automatically fill in the correct information for both Path and 
  420.       Program text boxes.  Drive information is optional if the file is 
  421.       on the same drive as ToyBox II.  Directory information is optional 
  422.       if the file is in the same directory as ToyBox II or one of the 
  423.       directories listed in the DOS PATH statement.  The directory must 
  424.       begin with a backslash ("\").
  425.  
  426.                     Example:  C:\NATHAN\GAMES\
  427.  
  428.            9)  Program Text Box:  Enter the command to execute the 
  429.       program, plus any optional parameters.
  430.  
  431.                     Example:  MICKABC /E
  432.  
  433.            10)  Icon Text Box:  Enter the complete path and filename of 
  434.       the icon to be displayed on the button.  The easiest way to do 
  435.       this is to use the Icons button described above, which will 
  436.       automatically fill in the correct information.  Drive information 
  437.       is optional if the icon file is on the same drive as ToyBox II.  
  438.       Directory information is optional if the icon is in the same 
  439.  
  440.  
  441.                                       8
  442.       directory as ToyBox II.  The directory must begin with "\".  If 
  443.       you don't put an extension on the file name, ToyBox II will assume 
  444.       a ".ICN" extension.
  445.  
  446.                     Example:  C:\ICONS\ABC.ICN
  447.  
  448.       ToyBox II can only use icons in ToyBox format, normally 
  449.       represented by a ".ICN" extension.  These icons can be designed 
  450.       using the Painter icon editor built into ToyBox II.  A number of 
  451.       sample icons are included on the ToyBox II disk.  Some of these 
  452.       icons were designed from scratch with Painter.  Others are 
  453.       Microsoft Windows icons that were imported and converted by 
  454.       Painter.  For instructions on designing and importing icons, see 
  455.       the "Painter" section below. 
  456.  
  457.            11)  Page Button:  Setting this to "YES" indicates that 
  458.       information being entered is for a button that will open a page 
  459.       (submenu).  In this case, anything entered in the Program and Path 
  460.       text boxes is ignored.  ToyBox II allows up to five levels of 
  461.       pages, which can hold thousands of programs.
  462.  
  463.            12)  Wait Button:  Setting this to "YES" causes ToyBox II to 
  464.       wait for ENTER to be pressed before redisplaying the current page 
  465.       after running the program.  This is useful if you need time to 
  466.       view the results of the program before ToyBox II reappears.
  467.  
  468.            13)  Variables Button:  Setting this to "YES" allows you to 
  469.       enter additional command line parameters at the time you run the 
  470.       program.  This is useful if you sometimes run the same program 
  471.       with different parameters.
  472.  
  473.            14)  Batch Button:  Set this to "YES" if the program is a 
  474.       batch file (a file with a ".BAT" extension), otherwise the program 
  475.       will not return to ToyBox II after it runs.  Another option for 
  476.       running a batch file (and actually the preferable option) if you 
  477.       are using MS-DOS 3.3 or later, is to leave this set to "NO" and 
  478.       precede the program name with the word "CALL" in the "Program" 
  479.       text box.
  480.  
  481.                     Example:  CALL MCGEE.BAT
  482.  
  483.            15)  OK Button:  After you have entered all necessary 
  484.       information, select the OK button with the mouse or press ALT+O to 
  485.       save the information to disk and close the window.  To close the 
  486.       window without adding the program/page, select the Close Window 
  487.       button in the upper left corner of the window or press the ESCAPE 
  488.       key.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.                                       9
  497.       ==========================
  498.       REMOVING A PROGRAM OR PAGE
  499.       ==========================
  500.  
  501.       Open the Helper window by selecting the Helper button (the red 
  502.       cross) or by pressing ALT+H.  Select the Remove Program or Page 
  503.       button to open the Remove Program or Page window.  This window 
  504.       lists the names of all the program/page buttons on the current 
  505.       page.  Select the program/page buttons you wish to remove, then 
  506.       select the OK button or press ALT+O.  To close the window without 
  507.       removing any programs, select the Close Window button with the 
  508.       mouse or press the ESCAPE key.  Removing a program from ToyBox II 
  509.       does not delete the program from disk.  It still exists and can be 
  510.       run normally from DOS or later added back to ToyBox II.  (If you 
  511.       try to remove a button for a page that itself has subpages, you 
  512.       will get a message saying "Pages containing subpages were not 
  513.       removed."  To remove the button in a case like this, you must 
  514.       first close the Helper window, open the page containing the 
  515.       subpages, and remove all the subpages individually.)
  516.  
  517.  
  518.       ===================================
  519.       VIEWING/MODIFYING A PROGRAM OR PAGE
  520.       ===================================
  521.  
  522.       Open the Helper window by selecting the Helper button (the red 
  523.       cross) or by pressing ALT+H.  Select the View/Modify Program or 
  524.       Page button to open the View/Modify window.  This window lists the 
  525.       names of all the program and page buttons on the current page.  
  526.       Select the program/page button you wish to view or modify.  A 
  527.       window titled View/Modify Program or Page will pop up containing 
  528.       the current information for that program/page button.  You can 
  529.       make any desired changes using the same techniques used in the Add 
  530.       Program or Page window.
  531.  
  532.  
  533.       =============================
  534.       SETTING HELPER WINDOW OPTIONS
  535.       =============================
  536.  
  537.       All pages have a Helper window which you can use to add, remove or 
  538.       view/modify program buttons on that page.  However, the following 
  539.       options are displayed only on the Helper window for the ToyBox II 
  540.       title page.
  541.  
  542.            1)  STOP Button:  Setting this to "NO" disables the STOP 
  543.       button on the ToyBox II title page.  To exit the program when the 
  544.       STOP button is disabled, you must press ALT+S.  As an additional 
  545.       level of security, you can password protect the ALT+S function.  
  546.       See paragraph 6 below.
  547.  
  548.  
  549.  
  550.  
  551.                                      10
  552.       2)  Helper Button:  Setting this to "NO" disables the Helper 
  553.       button on all pages.  To open the Helper window when the Helper 
  554.       button is disabled, you must press ALT+H.  As an additional level 
  555.       of security, you can password protect the ALT+H function.  See 
  556.       paragraph 6 below.
  557.  
  558.            3)  Disk Access:  Setting this to "NO" disables the Read Icon 
  559.       and Write Icon buttons in Painter.  Disabling these buttons allows 
  560.       a child (or other user) to use Painter without being able to 
  561.       access the disk and possibly corrupting files.  To access the Read 
  562.       Icon button when disk access is disabled, you must press ALT+R.  
  563.       To access the Write Icon button when disk access is disabled, you 
  564.       must press ALT+W.
  565.  
  566.            4)  Sound:  Setting this to "NO" turns off the occasional 
  567.       sounds that ToyBox II makes when certain keys are pressed.  This 
  568.       in no way affects the sound in the programs that you run under 
  569.       ToyBox II.
  570.  
  571.            5)  Cursor:  Setting this to "NO" turns off the red outline 
  572.       cursor used to indicate the current object on pages.  Users 
  573.       without a mouse should leave this set to "YES".  Users with a 
  574.       mouse can turn the cursor off if desired.
  575.  
  576.            6)  Password:  Enter an optional password a user must enter 
  577.       when attempting to exit the program with ALT+S or attempting to 
  578.       open the Helper Window with ALT+H.  The same password applies to   
  579.       both.  This password has no effect on individual programs or 
  580.       pages.  Passwords for these are set in the Add Program or Page or 
  581.       the View/Modify Program or Page windows.
  582.  
  583.            7)  OK Button:  After you have set the options the way you 
  584.       want them, select the OK button with the mouse or press ALT+O.  
  585.       This will save the current settings to disk and close the Helper 
  586.       window.  No changes take effect until they are saved to disk.  To 
  587.       close the Helper window without saving any changes, select the 
  588.       Close Window button with the mouse or press the ESCAPE key.
  589.  
  590.  
  591.       ============================
  592.       RUNNING AN INSTALLED PROGRAM
  593.       ============================
  594.  
  595.       After you have added a program button to ToyBox II, you can easily 
  596.       run the program by selecting the program button with the mouse, 
  597.       selecting it with the arrow keys and pressing ENTER (if the red 
  598.       outline cursor is enabled), or pressing the hot key associated 
  599.       with the program.  If you have entered the path and program 
  600.       information correctly, the program will start normally as it would 
  601.       from the DOS command line.  When you exit the program, ToyBox II 
  602.       will take over again and display the current page.
  603.  
  604.  
  605.  
  606.                                      11
  607.       =======
  608.       PAINTER
  609.       =======
  610.  
  611.       Painter is an icon editor built into ToyBox II.  With Painter you 
  612.       can design your own 32x32 pixel, 16 color icons for programs you 
  613.       install in ToyBox II, or you can import Microsoft Windows icons 
  614.       and convert them to ToyBox format.
  615.  
  616.  
  617.       PAINTING ICONS - MOUSE
  618.  
  619.       Choose a color by selecting any of the 16 palette buttons with the 
  620.       mouse.  The current color will always show in the box above the 
  621.       palette buttons.  After selecting a color, position the mouse 
  622.       pointer in the desired square on the large icon grid box, then 
  623.       press any mouse button.  The square will change to the current 
  624.       color.  To paint multiple squares with the same color, hold one of 
  625.       the mouse buttons down while dragging the mouse pointer over the 
  626.       squares you want to paint.  As you paint the icon on the large 
  627.       grid box, you will also see the effects displayed on the actual- 
  628.       size button to the right of the large grid box. 
  629.  
  630.  
  631.       PAINTING ICONS - KEYBOARD
  632.  
  633.       Choose a color by moving the red outline cursor to the desired 
  634.       palette button with the arrow keys, then press the ENTER key.  The 
  635.       current color will always show in the box above the palette 
  636.       buttons.  After selecting a color, press the SPACEBAR to move the 
  637.       cursor to the large icon grid box.  Move the small yellow grid 
  638.       cursor to the desired square using the arrow keys, then press the 
  639.       ENTER key.  The square will change to the current color.  To paint 
  640.       multiple squares with the same color, hold down the CTRL key as 
  641.       you press the left arrow, right arrow, Page Up, and Page Down 
  642.       keys.  The squares will be painted as the grid cursor moves over 
  643.       them.  (NOTE:  There are technical considerations with the IBM PC 
  644.       keyboard which force us to use CTRL-Page Up and CTRL-Page Down 
  645.       instead of CTRL-Up Arrow and CTRL-Down Arrow.  We realize it's 
  646.       more awkward than it should be.)  To move the cursor back to the 
  647.       palette buttons, press the SPACEBAR again.
  648.  
  649.  
  650.       FILL ALL BUTTON
  651.  
  652.       Select this button to fill the entire grid with the current color.
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                                      12
  662.       READ ICON BUTTON
  663.  
  664.       Select this button to read in an already-existing icon from disk.  
  665.       Selecting this button will cause a window with a text box to pop 
  666.       up.  Enter the path and file name of the icon file in the text 
  667.       box.
  668.  
  669.                     Example:  C:\ICONS\ABC.ICN
  670.  
  671.       The easiest way to do this is to select the Files button, which 
  672.       will cause a window containing a list of files to pop up.  This 
  673.       file list behaves exactly as the Files button described in the 
  674.       "Addding a Program or Page" section.  Drive information is 
  675.       optional if the icon file is the on same drive as ToyBox II.  
  676.       Directory information is optional if the icon file is in the same 
  677.       directory as ToyBox II.  The directory must begin with "\".  If 
  678.       you don't put an extension on the file name, Painter will assume a 
  679.       ".ICN" extension.  After you have entered the icon file 
  680.       information, press the ENTER key to read the icon file.  The icon 
  681.       will be displayed on the large icon grid box and the actual-size 
  682.       button to the right.  To close the window without reading an icon, 
  683.       select the red Close Window button.
  684.  
  685.  
  686.       WRITE ICON BUTTON
  687.  
  688.       Select this button to save the displayed icon to a disk file.  
  689.       Selecting this button will cause a window with a text box to pop 
  690.       up.  Enter the path and file name you wish to save the icon as.      
  691.       Use the same procedures as described in the previous paragraph.  
  692.       The only difference is that you must select the OK button with the 
  693.       mouse or press ALT+O to save the file to disk.  To close the 
  694.       window without writing the icon to disk, select the Close Window 
  695.       button.
  696.  
  697.  
  698.       IMPORTING MICROSOFT WINDOWS ICON FILES
  699.  
  700.       To import a Microsoft Windows icon file (normally with a ".ICO" 
  701.       extension), read it in like you would a normal ToyBox II icon.  
  702.       Painter will make the conversion as it reads the file in.  After 
  703.       you have made any desired changes to the icon, write it to disk.  
  704.       If you use the same file name, do not use the ".ICO" extension or 
  705.       you will write over the Windows version of the icon file.  If you 
  706.       don't specify an extension, Painter will attach a ".ICN" 
  707.       extension. 
  708.  
  709.       Thousands of Microsoft Windows icon files are freely available 
  710.       from bulletin board systems and on-line services such as 
  711.       CompuServe and GEnie, or available for a small charge from 
  712.       shareware disk vendors, or available for a substantial charge from 
  713.       commercial software vendors.
  714.  
  715.  
  716.                                      13
  717.       Painter can only import MS Windows icons that are in 32x32x16 
  718.       format (32 pixels by 32 pixels by 16 colors).  The vast majority 
  719.       of MS Windows icon files available are in this format.  Most MS 
  720.       Windows programs do not have separate icon files.  Instead, the 
  721.       icons are included in one of the program files (".EXE" or ".DLL").  
  722.       A single program file can have several icons stored in it.  
  723.       Painter cannot extract the icons from these files, but there are 
  724.       several shareware programs that can extract the icons and put them 
  725.       into separate icon files that Painter can import.
  726.  
  727.  
  728.       ===================
  729.       TIPS AND TECHNIQUES
  730.       ===================
  731.  
  732.  
  733.       RUNNING MULTIPLE COMMANDS
  734.  
  735.       ToyBox II allows you to directly run one program or DOS command 
  736.       per program button.  If you need to set up a button to run a 
  737.       series of programs or commands, you can do this by creating a 
  738.       batch file containing all the necessary commands and setting up a 
  739.       program button to run the batch file.  To easily create batch 
  740.       files you can set up a program button to open your favorite text 
  741.       editor or word processor.  The editor that is included with MS-DOS 
  742.       5.0 provides a quick, easy way to create, view and edit batch 
  743.       files and other text files.  Here is a sample setup for a program 
  744.       button to run the DOS editor:
  745.  
  746.            Button Title:  MS-DOS Editor        Page:        NO
  747.            Password:      (your choice)        Wait:        NO
  748.            Key:           E                    Variables:   YES *
  749.            Path:          C:\DOS\              Batch:       NO
  750.            Program:       EDIT
  751.            Icon:          C:\TB2\EDIT.ICN
  752.  
  753.            *  Setting Variables to "YES" will allow you to specify the 
  754.       file to edit as a command-line parameter at the time you run the 
  755.       editor.
  756.  
  757.  
  758.       FILE MANAGER
  759.  
  760.       ToyBox II does not include built-in file management features, but 
  761.       you can easily set up a program button to access your favorite 
  762.       file management program.  The DOS Shell included with MS-DOS 5.0 
  763.       provides a graphical file manager for copying, deleting and moving 
  764.       files and directories.  Here is a sample setup for a program 
  765.       button to run the DOS Shell program:
  766.  
  767.  
  768.  
  769.  
  770.  
  771.                                      14
  772.            Button Title:  MS-DOS Shell         Page:        NO
  773.            Password:      (your choice)        Wait:        NO
  774.            Key:           S                    Variables:   NO
  775.            Path:          C:\DOS\              Batch:       NO
  776.            Program:       DOSSHELL
  777.            Icon:          C:\TB2\SHELL.ICN
  778.  
  779.  
  780.       DOS COMMAND LINE
  781.  
  782.       In some cases you may find that you need to execute a program or 
  783.       DOS command from the DOS command line.  You have two choices.  The 
  784.       first choice is to exit from ToyBox II, execute the command and, 
  785.       when you're finished, start ToyBox II again.  A better solution, 
  786.       particularly if you will need to do this on a recurring basis, is 
  787.       to set up a program button to put you at the DOS command line 
  788.       temporarily without exiting ToyBox II.  This is done by using the 
  789.       COMMAND function of DOS.  The following sample program button, 
  790.       when selected, will display the DOS prompt.  You can run any 
  791.       programs/commands as you normally would from the command line.  To 
  792.       return to ToyBox II, type EXIT at the command line and the current 
  793.       ToyBox II page will reappear.
  794.  
  795.            Button Title:  MS-DOS Prompt        Page:        NO
  796.            Password:      (your choice)        Wait:        NO
  797.            Key:           S                    Variables:   NO
  798.            Path:          C:\DOS\              Batch:       NO
  799.            Program:       COMMAND
  800.            Icon:          C:\TB2\DOS.ICN
  801.  
  802.  
  803.       MICROSOFT WINDOWS PROGRAMS
  804.  
  805.       If you run Microsoft Windows, but also have a number of DOS (non- 
  806.       Windows) applications, you may find it convenient to run Windows 
  807.       as a program under ToyBox II.  You can install program buttons in 
  808.       ToyBox II for each of your DOS applications and set up your 
  809.       AUTOEXEC.BAT file to automatically open ToyBox II.  Since ToyBox 
  810.       II loads much faster than Windows, you won't have to wait for 
  811.       Windows to load before you access your DOS programs.  You can then 
  812.       set up a program button to open Windows as follows:
  813.  
  814.            Button Title:  Microsoft Windows    Page:        NO
  815.            Password:      (your choice)        Wait:        NO
  816.            Key:           W                    Variables:   NO
  817.            Path:          C:\WINDOWS\          Batch:       NO
  818.            Program:       WIN
  819.            Icon:          C:\TB2\WIN.ICN
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                      15
  827.       Another technique is to set up a page called "Windows Programs" 
  828.       and create separate program buttons for each of your Windows 
  829.       applications.  To automatically load Windows and run a specific 
  830.       Windows application, enter the Path and Program information as you 
  831.       would for a normal DOS application, then precede the program name 
  832.       with "WIN".  Here is a sample program button set up to load 
  833.       Windows and run Quicken for Windows:
  834.  
  835.            Button Title:  Quicken              Page:        NO
  836.            Password:      (your choice)        Wait:        NO
  837.            Key:           W                    Variables:   NO
  838.            Path:          C:\QUICKENW\         Batch:       NO
  839.            Program:       WIN QW.EXE
  840.            Icon:          C:\TB2\QUICKEN.ICN
  841.  
  842.  
  843.       ===================================
  844.       COMPATIBILITY WITH EARLIER VERSIONS
  845.       ===================================
  846.  
  847.       The configuration files for ToyBox II are incompatible with 
  848.       earlier versions of ToyBox.  If you are upgrading from an earlier 
  849.       version, you must reinstall programs in ToyBox II.  The icon files 
  850.       are compatible.  You can use the icons supplied with earlier 
  851.       versions, as well as any icons you have created yourself.
  852.  
  853.  
  854.       ====================
  855.       LICENSE AND WARRANTY
  856.       ====================
  857.  
  858.       THIS PROGRAM IS SUPPLIED AS IS.  THE AUTHOR DISCLAIMS ALL 
  859.       WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, 
  860.       THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. 
  861.       THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR 
  862.       CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS PROGRAM.
  863.  
  864.       ToyBox II is a "shareware program" and is provided at no charge to 
  865.       the user for evaluation.  Feel free to share it with others, but 
  866.       please do not give it away altered or as part of another system.  
  867.       The essence of "user-supported" software is to provide personal 
  868.       computer users with quality software without high prices, and yet 
  869.       to provide incentive for programmers to continue to develop new 
  870.       products.
  871.  
  872.       If you find ToyBox II helpful and you continue to use it after a 
  873.       reasonable trial period, you must make a registration payment of 
  874.       $29 to Virtual Magic Software as described in the "Registration" 
  875.       section of this User's Guide.  The $29 registration fee will 
  876.       license one copy for use on any one computer at any one time.  You 
  877.       must treat this software just like a book.  An example is that 
  878.       this software may be used by any number of people and may be 
  879.       freely moved from one computer location to another, as long as 
  880.  
  881.                                      16
  882.       there is no possibility of it being used at one location while 
  883.       it's being used at another.  Just as a book cannot be read by two 
  884.       different persons at the same time.
  885.  
  886.       Commercial and organizational users of ToyBox II must register and 
  887.       pay for their copies of ToyBox II within 30 days of first use or 
  888.       their license is withdrawn.  Site licenses can be arranged by 
  889.       contacting Virtual Magic Software.
  890.  
  891.       ToyBox II is a copyrighted program distributed as shareware. 
  892.       Distributors approved by the Association of Shareware 
  893.       Professionals (ASP) may immediately distribute ToyBox II.  Others 
  894.       wishing to distribute ToyBox II for payment must first contact 
  895.       Virtual Magic Software for authorization.  Not-for-profit users 
  896.       groups may distribute ToyBox II, and charge a fee for copying and 
  897.       disks, without prior authorization.  Electronic bulletin board 
  898.       systems (BBSs) may distribute ToyBox II without prior 
  899.       authorization.
  900.  
  901.  
  902.  
  903.  
  904.  
  905.       ToyBox is a trademark of Virtual Magic Software.
  906.       Windows is a trademark of Microsoft Corporation.
  907.       MS-DOS is a registered trademark of Microsoft Corporation.
  908.       Quicken is a registered trademark of Intuit.
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.                                      17
  936.